home *** CD-ROM | disk | FTP | other *** search
/ SPACE 1 / SPACE - Library 1 - Volume 1.iso / program / 245 / dialogcs.doc < prev    next >
Encoding:
Text File  |  1988-10-10  |  8.5 KB  |  326 lines
  1.  
  2.                       DIALOG CONSTRUCTION SET
  3.  
  4.                        Derrick Anthony Hall 
  5.                           Copyright 1988
  6.                         All rights reserved   
  7.                          Shareware Product
  8.   
  9.  
  10.   Dialog Construction Set, the resource editor for the rest of us, is 
  11.  
  12. written completely in GFA BASIC. The premise behind this program was
  13.  
  14. to create an RCS editor that would provide ease of use and offer
  15.  
  16. flexability at the sametime. This program was fully tested on the
  17.  
  18. 520 and 1040ST, with old and new roms.
  19.  
  20.                           THE DCS EDITOR
  21.  
  22.   If you have used Degas or any other paint programs, you'll feel at home 
  23.  
  24. within DCS editor. All that is needed on your part is a little
  25.  
  26. creativity. DCS does not support predesign GEM like dialog boxes, you
  27.  
  28. the user have to create them yourself. The DCS editor operates is
  29.  
  30. all three ST resolution modes.
  31.  
  32.   To get started double click on the filename "DIALOGCS.PRG", by doing
  33.  
  34. so you'll be launched into the DCS editor. The editor is very straight
  35.  
  36. forward, nothing to memorized.
  37.                                                  
  38.                           MENU FUNCTIONS
  39.  
  40. DIALOG Box:-Create up to 100 GEM dialog boxes. Press left mouse to draw
  41. box, release to position. The option will be given to either ADD, DELETE or
  42. CANCEL the dialog box that was been postioned. The CANCEL alert button only
  43. returns control back to the menu bar.
  44.  
  45. TOUCHEXIT Button:-Create up to 50 active exit buttons. Press left mouse to
  46. draw button, release to postion. When the button is positioned, you'll be
  47. given the option to add TEXT or DELETE button. TEXT, allows you to give a
  48. name to the button you're creating. DELETE, completely removes the button
  49. from the work screen. 
  50.  
  51. RADIO Button:-Create up to 50 active radio buttons. Press left mouse to
  52. draw button, release to postion. When the button is positioned. You'll be
  53. given the option to add TEXT or DELETE button. TEXT, allows you to give a
  54. name to the button you're creating. DELETE, completely removes the button
  55. from the work screen. 
  56.  
  57. HELP:-Gives a brief discription on all the menu commands.
  58.  
  59. CLEAR SCREEN:-Clear work area.
  60.  
  61. SAVE:-Generates .LST file to be merged inside GFA BASIC interpreter.
  62.  
  63. DELETE:-Trash unwanted files on diskette.
  64.  
  65. WRITE DIALOG TEXT:-Write text to be positioned within dialog box area.
  66.  
  67. ON ACCESSORIES:-Activate accessory menu for selection.
  68.  
  69. OFF ACCESSORIES:-Deactivate accessory menu
  70.  
  71. QUIT:-Exit to GEM desktop
  72.  
  73.  
  74.  
  75.                          GFA BASIC KEYWORDS
  76.  
  77.   To change text font and color use the DEFTEXT keyword within GFA BASIC
  78.  
  79. see below.
  80.  
  81.   DEFTEXT c,s,r,g : "c" represents the number of preselected color
  82.  
  83. registers, high res 0 to 1, medium res 0 to 3, and low res 0 to 15.
  84.  
  85. "s" defines the style to be used by deftext, 0=normal, 1=bold face
  86.                                
  87. 2=light, 4=italic, 8=underlined, 16=outlined and 24=underlined &
  88.  
  89. outline. "r" defines the rotation angle, 0=normal, 900=90 degrees,
  90.  
  91. 1800=180 degrees and 2700=270 degrees. "g" defines the height of the
  92.  
  93. characters in graphic dots,4=very small, 6=standard(color), 
  94.  
  95. 13=standard(monochrome) and 32=enlarged.
  96.                                                               
  97.   DEFLINE is used to set the line size and pattern. This is useful
  98.  
  99. if you wish to highlight an default button box.
  100.  
  101.   DEFFILL will be one of the most used GFA BASIC keywords within DCS
  102.  
  103. generated code, when modifying dialog boxes to be filled with patterns
  104.  
  105. or colors.
  106.  
  107.  
  108.                    EDITABLE DIALOG BOX ROUTINE
  109.   
  110.   Print At(20,10);"Name   :"+Space$(25)
  111.  
  112.   Print At(20,11);"Address:"+Space$(25)
  113.  
  114.   Print At(20,12);"City   :"+Space$(25)
  115.  
  116.   Print At(20,13);"State  :"+Space$(25)
  117.  
  118.   Print At(20,14);"Zip    :"+Space$(25)
  119.  
  120.   Print At(29,10);
  121.  
  122.   Form Input 25,Name$
  123.  
  124.   Print At(29,11);
  125.  
  126.   Form Input 25,Address$
  127.  
  128.   Print At(29,12);
  129.  
  130.   Form Input 25,City$
  131.  
  132.   Print At(29,13);
  133.  
  134.   Form Input 25,State$
  135.  
  136.   Print At(29,14);
  137.  
  138.   Form Input 25,Szip$
  139.                                                      
  140.  
  141.  
  142. They're many ways to create an edit routine for
  143.  
  144. homemade dialog boxes, for a excellent demo see page 49 of the new
  145.  
  146. GFA BASIC BOOK from Michtron, Inc.
  147.                                  
  148.                                                   
  149.                    GROW AND SHRINK VISUAL EFFECT
  150.  
  151.  
  152.      In every DCS generated .LST file you'll find an routine call
  153.  
  154. "Shrink_grow". This routine is used to achieve the visual opening and
  155.  
  156. closing effect when each dialog box is selected and closed. You can call
  157.  
  158. this routine by doing the following:
  159.       
  160.  
  161.          @Shrink_grow(Gem,lightx,lighty,wsgx,hsgy,lox,loy,wx,hy)
  162.  
  163.  
  164. GEM=1 open grow effect 
  165.  
  166. GEM=0 close shrink effect
  167.  
  168. Lightx,lighty=X,Y location of the shrink and grow box
  169.  
  170. wsgx, hsgy=width and height of the shrink and grow box
  171.  
  172. lox, loy=X,Y location of the dialog box
  173.  
  174. wx,hy=width and height of the dialog box
  175.     
  176.                                                                                                      
  177.                         COMPLEX DIALOG BOXES 
  178.  
  179.   One of the ways to create complex dialog boxes, is to use your ST
  180.  
  181. monitor screen has a template. I'm sure it can be done in other ways,
  182.  
  183. since the screen template is easier and works best. Before designing any
  184.  
  185. complex dialog boxes, you should have an idea on the type of dialog box
  186.  
  187. you wish to create. A template is necessary if you wish to position
  188.  
  189. buttons and dialog boxes properly. All that is needed is
  190.  
  191. a soft tip magic marker to draw points on monitor screen. This will
  192.                                   
  193. guide you in creating boxes in a more precision layed out manner.
  194.  
  195. After you have gotten  use to the editor and designing dialog and 
  196.  
  197. button boxes, this unorthodox screen template won't be necessary.
  198.  
  199. Credit boxes are the easiest to create within any RCS editor, for all
  200.  
  201. that is needed is an dialog outline and an active button box. 
  202.  
  203.                                             
  204.                         RESET BACK TO NORMAL
  205.  
  206.   If you should modify the Dialog Construction Set generated .LST file
  207.  
  208. code to accept different fill patterns and fonts, reset the GFA BASIC
  209.  
  210. commands back to normal. It is very important that you reset these
  211.  
  212. keywords or else your dialog box outcome won't be pleasing.
  213.  
  214.  
  215.      Set text font                Reset text font back to normal
  216.  
  217.     DEFTEXT 2,1,0,6                 DEFTEXT 1,0,0,6(color mode)
  218.  
  219.     DEFTEXT 1,1,0,32                DEFTEXT 1,0,0,13(monochrome mode)
  220.  
  221.      Set line pattern             Reset line pattern back to normal
  222.  
  223.     DEFLINE 1,10,2,1                DEFLINE 1,1,0,0
  224.  
  225.      Set fill pattern             Reset fill pattern back to normal
  226.  
  227.     DEFFILL 1,2,2                   DEFFILL 0,1,1   
  228.  
  229.                                                   
  230.  
  231.           CALLING DCS DIALOG BOX ROUTINE WITHIN YOUR PROGRAM
  232.  
  233.   When you have completed your dialog boxes within DCS editor, marge
  234.  
  235. the .LST file inside GFA BASIC editor. To actually use or call your
  236.  
  237. procedure you will have to use one of the following methods:
  238.  
  239.  
  240.        @DIALOG_BOX
  241.        
  242.          or
  243.       
  244.        GOSUB DIALOG_BOX
  245.  
  246.                               
  247.                          ASCII CODES
  248.  
  249.    How to obtain various ST ASCII symbols and characters within Dialog
  250.  
  251. Construction Set text editor. These symbols and characters may serve
  252.  
  253. useful when designing dialog boxes and GEM like windows. 
  254.  
  255.   Alternate-Control-E ( Close window symbol )                             
  256.  
  257.           "        -F ( Resize window symbol
  258.  
  259.           "        -I ( Clock symbol )
  260.  
  261.           "        -O ( Atari right logo symbol )
  262.  
  263.           "        -D ( Left arrow )
  264.  
  265.           "        -G ( Open window symbol )
  266.  
  267.           "        -K ( Music symbol )
  268.  
  269.           "        -C ( Right arrow )                                
  270.  
  271.           "        -B ( Down arrow )
  272.  
  273.           "        -N ( Atari left logo symbol )
  274.           
  275.     Alternate-Shift-Z ( Quarter character symbol )
  276.  
  277.           Alternate-F3 ( Copyright symbol )
  278.  
  279.               "    -F4 ( Register symbol )
  280.  
  281.               "    -F5 ( Trade mark symbol )                
  282.  
  283.                                  
  284. Dialog Construction Set is an extremely powerful resource construction
  285.  
  286. set editor for GFA BASIC, but every effort was being made to keep it
  287.  
  288. very small in bytes and simple, yet powerful enough to satisfy most 
  289.  
  290. users. Hope you have fun using this program as I did writing it, enjoy.
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.